home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir37 / main120.zip / MAINMENU.DOC < prev    next >
Text File  |  1993-06-18  |  15KB  |  291 lines
  1.  
  2.  
  3.                              TSB SYSTEMS PRESENTS  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.    ┌───────┐ ┌──────┐ ┌───┐ ┌──┐   ┌─┐ ┌───────┐ ┌─────┐ ┌──┐   ┌─┐ ┌─┐  ┌─┐
  10.    │ ┌┐ ┌┐ │ │ ┌──┐ │ └┐ ┌┘ │  └─┐ │ │ │ ┌┐ ┌┐ │ │ ┌───┘ │  └─┐ │ │ │ │  │ │
  11.    │ ││ ││ │ │ └──┘ │  │ │  │ ┌┐ └┐│ │ │ ││ ││ │ │ └─┐   │ ┌┐ └┐│ │ │ │  │ │
  12.    │ │└─┘│ │ │ ┌──┐ │  │ │  │ │└┐ └┘ │ │ │└─┘│ │ │ ┌─┘   │ │└┐ └┘ │ │ │  │ │
  13.    │ │   │ │ │ │  │ │ ┌┘ └┐ │ │ └─┐  │ │ │   │ │ │ └───┐ │ │ └─┐  │ │ └──┘ │
  14.    └─┘   └─┘ └─┘  └─┘ └───┘ └─┘   └──┘ └─┘   └─┘ └─────┘ └─┘   └──┘ └──────┘
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                          A COMPLETE MENUING SYSTEM
  21.                            VER 1.20   06-18-1993
  22.  
  23.  
  24. REQUIRED FILES:
  25.                       Tsbmenu .Bat  - You MUST use this to start
  26.                       Mainmenu.Cfg  - Configuration File
  27.                           *   .Dat  - Menu data files
  28.                       Mainmenu.Exe  - Main program
  29. -------------------------------------------------------------------------------
  30. HARDWARE:
  31.  
  32.      Graphics: EGA (640x480) or VGA
  33.      CPU     : The faster the better (386 at least)
  34.      MOUSE   : Microsoft compatible (not required)
  35. -------------------------------------------------------------------------------
  36. SETUP:
  37.  
  38.      ALL of the files  listed above  MUST be in  the directory defined in
  39.      the configuration file for the program to operate correctly.
  40.  
  41.      Make a directory named C:\MENU.  Copy all the files to this dir. Run
  42.      Tsbmenu.Bat. If changing the program path edit Mainmenu.Cfg (line 3)
  43.      or see MAINMENU.CFG, F3-C.
  44. -------------------------------------------------------------------------------
  45. GENERAL:
  46.  
  47. *    Up to 230 items (10 M's x 23 S's) per menu file.  Up  to 15 commands
  48.      'B' can be entered for each item. If command is a .Bat file you MUST
  49.      use the CALL command (or Command /c filename) to return to the menu.
  50.      
  51.      To make a selection, use the arrow keys or press the highlighted key
  52.      then <ENTER>,  or  double-click on selection with left mouse button.
  53.      When a main category is already open,  using the left or right arrow 
  54.      keys will open the adjacent category  (or click on new main category
  55.      name with left mouse button).  Your previous select location will be 
  56.      remembered until you press ESC twice (or load a new menu file) which 
  57.      closes the category and resets all locations to the first selection.
  58.      ESC, when no submenu is open, will clear ALL locations in sub menus.
  59.  
  60.      If you  use  a parameter,  with  Tsbmenu.Bat it will a load any menu
  61.      file (.Dat)  and ignore,  but not change,  the current default name.
  62.      Example:   Tsbmenu games              (games.dat MUST already exist)
  63.      
  64.      F4  calls your  External editor (if not in the path, AND not in the
  65.      configuration directory you MUST specify the full pathname) to edit
  66.      .Dat files.  If you edit your current .Dat file it will reload your
  67.      edited file.
  68.  
  69.      <SPACE> or moving mouse to upper-right corner, will blank the screen
  70.      immediately.  Pressing any key, or  clicking right mouse button will
  71.      exit the blanker.  If Sys password is active,  (does NOT = NONE) you
  72.      will be required to enter a password to return to  the menu.  Either
  73.      password (Sys or Key) will work  here.  This is true whether blanker
  74.      is activated by the space bar or by elapsed time.
  75.  
  76.      F7 is a "hidden" feature which provides screen blanking, with return
  77.      to  the menu requiring the Key password (ONLY).  If the Key password
  78.      is not active then it will do nothing.
  79.  
  80.      F10 is a "hidden" feature for displaying pop-up tsr's.(see TECHNICAL)
  81.  
  82.      Will currently list up to 155 available menu (.Dat) files on screen.
  83.  
  84.      The left button (only 2 buttons are currently supported) on the mouse
  85.      simulates <ENTER>, the right button simulates <ESC>.
  86. -------------------------------------------------------------------------------
  87. MAINMENU.CFG - Format (see examples):
  88.  
  89.      Contains Password(s), Drive:\ Path to menu files, default .Dat file,
  90.      Menu Log information, External editor name, Screen blank time,  the 
  91.      Command to execute on Exit and Color information.
  92.  
  93.      The password is for the function keys and  specified 'S'ubmenus and
  94.      can be up  to 16 characters.  If password try goes past 3 will give
  95.      message and 1 more try (if present you MUST use the 'KEY' password)
  96.      or the system will lock.  If a submenu item  is  password protected
  97.      there will be an asterisk (*)  to the left.  If you need a separate
  98.      password for the Function keys than you have for the submenus,  use
  99.      the 'KEY' password.  This password  will work for  Function keys OR
  100.      Submenus, the other will be for Submenus  ONLY.  If the password in
  101.      configuration = NONE then that password is disabled.
  102.  
  103. *    If changing the program path (F3-C), all relevant files MUST already
  104.      exist in  the NEW path (make sure line 3 reflects the proper path in
  105.      ALL directories). The NEW .Cfg  file will be used although all other
  106.      changes (F3)  will be recorded in the  old .Cfg.  This allows you to
  107.      have a separate group of .Dat files with a separate configuration in
  108.      an alternate directory.
  109.  
  110.      The Drive MUST be specified along with the Path.   Example:  C:\MENU
  111.  
  112.      The menu Log tracks the date,  time and commands  used for each menu
  113.      selection and can be turned ON or OFF.
  114.  
  115.      The Exit command is what will be executed when you Quit the menu. To
  116.      disable this feature it MUST equal NONE.
  117.  
  118.      Color information is the customized colors for the menu system.
  119. -------------------------------------------------------------------------------
  120. MAINMENU.DAT - Format (see examples):
  121.  
  122.      'M' = Main item/Password    'S' = Sub item/Password    'B' = Command/Parm
  123.      'L' = Load menu             'T' = Title                'E' = End/Drive
  124.      '-' = Comment (dash)
  125.      
  126.      ALL descriptors & first letter of 'M' & 'S' items MUST be upper case.
  127.  
  128.      'E' indicates the END of the menu file and  MUST be present.  If not 
  129.      blank, it also specifies drive to change to  for the WHOLE menu file 
  130.      before running a command. IF present, specifier will be added to ALL 
  131.      selections (except Function keys) prior to any other commands.
  132.  
  133.      If '-'(dash) is used it allows non-displayable comments in menu file.
  134.      
  135.      When 'S' is a string  of '─' [chr$(196)],  this item will be printed
  136.      on  the menu and count toward  item count (230)  but will be skipped
  137.      when arrowing up or down. DO NOT put at the end of a category OR one
  138.      on top of another (2 of these together).
  139.  
  140.      If 'S' is  followed immediately by a 1  ('S1') then  this subitem is
  141.      protected by the System Password in the configuration.(see examples)
  142.  
  143.      If 'M' is  followed immediately by a 1  ('M1') then  ALL subitems in 
  144.      that category are protected by the System Password.   (see examples)
  145.  
  146.      If 'B' is  followed immediately by a P  ('BP') then you MUST provide
  147.      parameter TEXT enclosed in quotes and limited to 30 characters.  You
  148.      will be prompted with this text for a parameter to use with (add to)
  149.      the command that follows.    (see examples)
  150.      
  151.      If  'L' is used instead of 'B', program will load another .Dat file.
  152.      The 'L' command MUST be the ONLY command for that sub item.
  153.  
  154.      If 'T' is used it displays a "double-spaced" title.  You may want to
  155.      put extra spaces between words.  The title is displayed when file is
  156.      initially loaded or when no main category is selected.
  157. -------------------------------------------------------------------------------
  158. TECHNICAL:
  159.  
  160.      There are actually three parameters:  menuname, column, row to open.
  161.  
  162. *    Program uses screen mode 12 (640x480).  Because of this MOST memory-
  163.      resident  pop-ups will not pop up through the menu environment.  The 
  164.      "hidden" F10 key feature has been provided for this reason. F10 will
  165.      change you to standard text mode (screen mode 0), and wait for a key
  166.      press.  At which time, you WILL have access to your pop-up programs.
  167.      Program exits with screen mode 0.
  168.      
  169.      Rewrites Tsbmenu.bat for 256 byte memory usage. Totally unloads from
  170.      memory for execution of ALL commands except F1 and F4.  F1 (Dos Cmd)
  171.      and F4 (Editor) are shells and can use up to 106K of memory plus the
  172.      size of your editor program or dos command.
  173.  
  174.      Uses symbol # internally. Do NOT use ANY commands that begin with #.
  175.  
  176.      If  too  many  items  in  menu, it will exit with a location number:
  177.      L = Main Titles (M's)    LO = Subtitles (S's)   LOO = Commands (B's)
  178.      
  179.      When the menu is visible you're ALWAYS in the dir defined in config.
  180.  
  181.      Ctrl-Break or Ctrl-C has not been totally disabled. If you are at an 
  182.      input prompt, (ie:  F1,  F2 or F4), if the keys Ctrl-Break or Ctrl-C 
  183.      are pressed, if it's the first selection made, will allow an exit to
  184.      DOS, if not then the last selection made will be performed again. To
  185.      avoid security breeches, password function keys with a Key password.
  186.  
  187.      Written and compiled with Quickbasic 4.5.
  188. -------------------------------------------------------------------------------
  189. EXAMPLES:
  190.  
  191.   Mainmenu.Cfg          PASSWORD    - Function key password only
  192.                         NONE        - System password is disabled
  193.                         C:\MENU     - Path to program files
  194.                         MAINMENU    - Default .Dat file to load
  195.                         OFF         - Log has been turned off
  196.                         LOG.MNU     - Default log filename
  197.                         EDIT.COM    - External editor name
  198.                         3           - Minutes to screen blanker
  199.                         NONE        - Disabled 'on exit' command
  200.                         7           - Main screen color
  201.                         1           - Header color
  202.                         11          - Border color
  203.                         14          - Highlighted letter color
  204.                         10          - Highlighted text color (bar)
  205.                         7           - Non-highlighted text color
  206.                         15          - Menu text color
  207.    -----------------------------------------------------------------
  208.    Mainmenu.Dat   T MAIN  MENU      - Title
  209.                   M Utilities       - Main category
  210.                   S Quit            - Sub item (not protected)
  211.                   B exit            - Command
  212.                   S ─────────       - Displayable separator
  213.                   S1Dos shell       - Password protected (NO spaces)
  214.                   B command
  215.                   S Norton's utils  -  not protected
  216.                   B cd\norton
  217.                   B command /c nt   - "Called" .Bat file (see GENERAL)
  218.                   ----------------  - Non-displayable comment/separator
  219.                   M1Disk            - ALL S's under this are protected
  220.                   S Format a:
  221.                   BP"Enter Paramater: "format a: - user parameter (like - \s)
  222.                   S Format b:
  223.                   B format b: \s
  224.                   E D:              - Change to drive D: for whole file
  225. -------------------------------------------------------------------------------
  226.                            D I S T R I B U T I O N
  227.  
  228.    You are encouraged to freely distribute  copies of this program subject
  229.    to the following conditons:
  230.  
  231.    A.   No renumeration may be accepted for this program or  accompanying 
  232.         files.  This does not include  system access fees which may apply
  233.         to subcribers of bulletin board systems, online services,  etc...
  234.  
  235.    B.   Program must be copied in  unaltered form,  complete with license 
  236.         information, FULL documentation and all accompanying files. 
  237.  
  238.    C.   All shareware houses / distribution firms  must make it explicitly 
  239.         clear that the diskette purchased containing this program does NOT 
  240.         include registration of the program and the accompanying files.
  241.  
  242.    This program and the accompanying files  may  not  be circulated in any 
  243.    incomplete or modified form, nor sold or distributed for profit without 
  244.    the express and written permission of the author.  
  245.    
  246.    Commercial  distributors may  distribute this  program / files, subject 
  247.    to the above conditions, only after  obtaining  WRITTEN permission from
  248.    the author. This condition statement supersedes all previous agreements.
  249. -----------------------------------------------------------------------------
  250.                 L I C E N S I N G   a n d  D I S C L A I M E R
  251.  
  252.    MAINMENU is defined as this program and all of its accompanying files.
  253.  
  254.    MAINMENU is  distributed  on  an  "As-is"  basis,  with no  warranties 
  255.    expressed or implied. The author and distributors  assume no liability 
  256.    for damages, either from the direct use / registration of this product 
  257.    or as a consequence of the use / registration of this product.
  258.  
  259.    MAINMENU may  NOT be modified in any respect, for any reason, including
  260.    but not limited to, de-compiling, disassembling or reverse  engineering 
  261.    of the program.   The opening  title screen  and  all other proprietary  
  262.    program output must never be altered,  removed, bypassed or modified by 
  263.    any means.  
  264.  
  265.    Any  corporation or institution  wishing to use this program / files in 
  266.    the course of its business  must  purchase a  SITE LICENSE.  A standard 
  267.    license which allows usage on up to 20 different computers. A disk with 
  268.    the latest release will be included at no additional charge.    (Please 
  269.    specify 360k, 720k, 1.2 or 1.44 disk).
  270.  
  271.    Non-registered users are granted a limited license(30 days) to evaluate 
  272.    the programs suitability for their requirements.   Any usage beyond the 
  273.    30 day evaluation time period requires registration of each copy of the 
  274.    program used. Use of non-registered copies beyond the evaluation period 
  275.    is prohibited.
  276.  
  277.    To ensure continued quality products and upgrades ...PLEASE REGISTER...
  278.  
  279.    A program license for non-commercial use on one machine is only $24.95.
  280. -----------------------------------------------------------------------------
  281.  
  282.    For bulk rate discount, custom tailored version,  Site License, helpful
  283.    suggestions and/or comments, information, upgrades or technical support 
  284.    (registered users only), or to register  (send version number and check
  285.    payable to: Terry Bever) contact:
  286.  
  287.                                 TSB SYSTEMS
  288.                                 P.O. BOX 2448
  289.                                 BRADENTON, FL  34208
  290. (End-of-File) ---------------------------------------------------------------
  291.